# "Interpretation Rules.txt"
# Adobe After Effects Automatic Footage Interpretation
#  
# lines beginning with "#" are comments
#
# basic format of a hard rule: {match requirements} = {set interpretation}
# basic format of a soft rule: {match requirements} ~ {set interpretation}
#
# + for each rule that matches, the interpretation is set; wild-cards ("*") allowed
#   on both sides; wildcard match matches anything, wildcard set sets nothing
# + multiple rules are allowed to match, later matches override earlier matches
# + all rules are scanned in order, one rule per line
# + rules are applied after pixel aspect ratio, alpha information, and field label
#   information is read from a file
#
# + soft rules will not override values that are specified explicitly by the file format
#
# width, height, frame-rate, file-type, codec = 
# 	pixel aspect ratio/name, field order, conform frame-rate, alpha interp
#
# width & height are integer numbers
# frame-rate is a decimal number
# file-type is four characters in quotes (4c's)
# codec (applicable for QT & AVI only) is also 4c's
#
# to find out the file-type and/or codec 4c's for a specific type of footage,
#	opt-click (Mac) or alt-click (Windows) on the footage in the project window;
#	the 4c codes will appear in the last line of text by the thumbnail
#
# the pixel aspect ratio is a ratio of integers (e.g. 10/11)
#   optionally followed by a name for that ratio (e.g. 10/11/"My Aspect")
# the field order is a single character, (F=frame, U=upper field, or L=lower field)
# the conform frame-rate is a decimal number
# alpha interp: (I=ignore, S=straight, P=premul/black, W=premul/white)
#	alpha interp is ignored for footage without an alpha channel
#

# soft rule; assume ATSC 704x480 in any format is D1 aspect
704, 480, 29.97, *, * ~ 648/720, *, *, *

# NTSC rules
# soft rule; assume 720x480 29.97fps formats are DV NTSC (lower, NTSC D1/DV aspect)
# soft rule; assume 720x480 formats with all frame rates have NTSC DV/D1 pixel aspect ratio
# soft rule; assume 720x486 formats with all frame rates have NTSC DV/D1 pixel aspect ratio
720, 480, 29.97, *, * ~ 648/720, L, *, *
720, 480, *, *, * ~ 648/720, *, *, *
720, 486, *, *, * ~ 648/720, *, *, *

# PAL rules
# soft rule; assume 720x576 25fps formats are DV PAL (lower, PAL D1/DV aspect)
# soft rule; assume 720x576 formats with all frame rates have PAL DV/D1 pixel aspect ratio 
720, 576, 25, *, * ~ 768/720, L, *, *
720, 576, *, *, * ~ 768/720, *, *, *

# D16/D4 rules
# soft rules; assume 2880x2048, 1440x1024 formats with all frame rates D16/D4 pixel aspect ratio
2880, 2048, *, *, * ~ 128/135, *, *, *
1440, 1024, *, *, * ~ 128/135, *, *, *

# assume NTSC DV is D1 aspect, lower-field
# <obsolete rules -- superceded by soft rules above>
# 720, 480, 29.97, "MooV", "dvc " = 648/720, L, *, *
# 720, 480, 29.97, "MooV", "dvpn" = 648/720, L, *, *
# 720, 480, 29.97, ".AVI", "dvsd" = 648/720, L, *, *


# hardware- and format-specific rules

# Media 100 640 x 480 is square-pixel, upper-field first
640, 480, 29.97, "MooV", "dtmt" = 1/1, U, *, *

# Media 100 Finish 720 x 486 is D1-pixel-aspect, lower-field first
720, 486, 29.97, "MooV", "dtNT" = 648/720, L, *, *

# assume Matrox DigiSuite is D1-pixel-aspect, lower-field first
720, 486, 29.97, ".AVI", "MJPG" = 648/720, L, *, *

# assume Pinnacle Targa 3000 YUV is D1-pixel-aspect, lower-field first
720, 486, 29.97, ".AVI", "UYVY" = 648/720, L, *, *

# Media 100 Mac 720 x 486 is field-labeled by Media 100, and
# can be upper or lower depending on the hardware, but
# uncomment the next line to force D1, lower-field first
# 720, 486, 29.97, "MooV", "dtmt" = 648/720, L, *, *

# Avid 640x480 is square-pixel, upper-field first
640, 480, *, "MooV", "avr " = 1/1, U, *, *

# Electric Image writes straight alpha files
*, *, *, "EIDI", * = *, *, *, S

# only adds a custom pixel aspect ratio to the popup in the Comp Settings & Interpret Footage
# dialog boxes -- uncomment the next line to try it out
# 0, 0, 0, "0000", * = 10/11/"Custom Aspect", *, *, *